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Preface 


The VAX Distributed Name Service (DNS) provides you with a net- 
workwide means of assigning unique, location—independent names to 
network resources, also known as objects. Objects can be files, disks, 
nodes, queues, mailboxes, and so forth. A DNS object name is known 
and updated networkwide, so that all users and applications in your 
network can access an object using the same, unique name. Because 
DNS names are location independent, users and applications do not 
need to know on which node an object resides. DNS translates an 
object’s name to a set of attributes; its network address is one of these 
attributes. 


Applications that are designed to work with DNS use DNS names to 
name their objects. For example, DNS is currently a prerequisite for 
the Remote System Manager (RSM) V2.0 and the VAX Distributed File 
Service (DFS), both of which use DNS names for their objects. 


Over time, additional Digital applications will use DNS to name their 
objects. In DECnet Phase V networks, node names will be DNS names 
that are stored on DNS server nodes. 


This manual tells you how to install DNS. It also tells you how to run 
the DNS installation verification procedure. 


intended Audience 


This manual is intended for anyone who will install DNS in their net- 
work. The reader should be familiar with the VMSINSTAL procedure. 
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Document Structure 


This manual contains the following chapters and appendixes: 


Chapter 1 tells you what you must do before you install DNS 
software. 


Chapter 2 tells you how to use the VMSINSTAL procedure to 
install DNS. It also tells you how to run and interpret the output of 
the Installation Verification Procedure. 


Chapter 3 describes postinstallation tasks. 


Chapter 4 lists error messages that you might receive while you 
install DNS and tells you how to deal with them. 


Appendix A lists files created or modified by the DNS installation. 


Appendix B contains two sample DNS installation dialogues for 
VMS Version 4.6 and Version 4.7 systems. The first sample depicts 
the installation of the first DNS server in a network; the second 
sample depicts the installation of a subsequent DNS server. 


Appendix C contains two sample DNS installation dialogues for 
VMS Version 5.0 systems. The first sample depicts the installation 
of the first DNS server in a network; the second sample depicts the 
installation of a subsequent DNS server. 


Associated Documents 


You should have the following additional documents available for 
reference: 


viii 


VAX Distributed Name Service Management Guide 
Guide to VAX/VMS Software Installation 
VAX/VMS System Manager’s Reference Manual 
VMS License Management Utility Manual 


You must be familiar with basic DNS concepts before you can success— 
fully install DNS in your network. Therefore, read Chapters 1 and 2 of 
the management guide before you try to install DNS. 


Conventions 


Special type 


Red type 


UPPERCASE 


lowercase italics 


[] 


This special type in examples indicates system 
output or user input. 


Red type in examples indicates user input. 
Press the RETURN key. 


Uppercase letters in command lines indicate 
keywords that must be entered. You can enter 
them in either uppercase or lowercase. You 
can abbreviate command keywords to the 
first three characters or the minimum unique 
abbreviation. 


Lowercase italics in command syntax or 
examples indicate variables for which either 
the user or the system supplies a value. 


Square brackets in the installation dialogue 
enclose default_answers. To choose the 
default, press [RET|, To specify another 
answer, type the answer after the question 


and press 


Hold down the CONTROL key and then press 
the key specified by x. 


Chapter 1 
Preinstallation Considerations 


The VAX Distributed Name Service (DNS) provides you with a net- 
workwide means of assigning unique, location—independent names to 
network resources, also known as objects. Objects can be files, disks, 
nodes, queues, mailboxes, and so forth. A DNS object name is known 
and updated networkwide, so that all users and applications in your 
network can access an object using the same, unique name. Because 
DNS names are location independent, users and applications do not 
need to know on which node an object resides. DNS translates an 
object’s name to a set of attributes; its network address is one of these 
attributes. 


Applications that are designed to work with DNS use DNS names 
to name their objects. For example, DNS is a prerequisite for the 
following applications: 


¢ Remote System Manager (RSM) V2.0 
e VAX Distributed File Service (DFS) 
You must install DNS before you can install and use RSM, DFS, or any 
other Digital applications supported by DNS. 
NOTE 


Before you try to install DNS, read Chapters 1 and 2 of 
the VAX Distributed Name Service Management Guide. 
Successful installation of DNS requires that you understand 
the key DNS concepts outlined in those chapters. 


Preinstallation Considerations 1—1 


You must perform the following tasks before you install and start DNS 
software and verify its installation: 


¢ Make sure that the system on which you are going to install DNS 
is configured properly, as described in this chapter. 


¢ Plan the location of one or more DNS servers in your network, 
as described in Chapter 2 of the VAX Distributed Name Service 
Management Guide. 


¢ If you are installing DNS on a VMS Version 5.0 system, make sure 
that you have first registered a Product Authorization Key (PAK) 
for DNS, as described in Section 1.1.4. 


e Ifthe DNS server that you are installing is not the first in your 
network, refer to Section 1.2, which describes considerations for 
second and subsequent DNS installations. 


¢ Invoke the VMSINSTAL procedure and respond to questions dis— 
played at your terminal. 


¢ Perform postinstallation tasks, as described in Chapter 3. 


1.1. Installation Requirements 


You must fulfill the following requirements before you can install DNS 
software. 


1.1.1. Kit Contents 


DNS software is available in three distribution kits: 


¢ RX50 floppy disk 

¢ TK50 cartridge tape cartridge 

¢ Magnetic tape, 1600-bpi, 9-track 

The Software Bill of Materials accompanying the distribution kit 
specifies the quantity and contents of your media as well as the docu- 


mentation you receive. The documentation set for DNS consists of this 
manual and the VAX Distributed Name Service Management Guide. 


Contact your Digital representative if any components are missing. 
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1.1.2 Hardware 


You can use DNS on any VAX processor except MicroVAX I and 
VAXstation I. DNS requires a communications device supported by 
DECnet-VAX, such as QNA or DMP. 


1.1.3 Software 


To install DNS, you must have installed VMS V4.6 or later. You must 
also have installed DECnet—VAX V4.6 or later. 


On a VMS Version 5.0 system, before you can install DNS, you must 
use the LMF utility to register and load a license PAK for the DNS 
product, as described in Section 1.1.4. 


1.1.4 Product Authorization Key (PAK) 


DNS supports the VMS License Management Facility (LMF) provided 
by VMS Version 5.0. Before you can install DNS on a VMS Version 

5.0 system, LMF requires that you first register a license Product 
Authorization Key (license PAK) for the DNS product. License PAK in- 
formation is provided with the DNS product and you register and load 
this information into your system’s license database using the VMS 
LMF utility. Refer to the instructions in the VMS License Management 
Utility Manual for more information. 


1.1.5 Disk Space 


Installation of DNS requires a total of 7000 blocks of free disk space. 
During installation, if you do not choose the default disk for the 
DNS$SERVER directory, you will need 2000 free blocks on the sys— 
tem disk (SYS$SYSDEVICE) and 5000 free blocks on the disk you 
specify for the DNS$SERVER directory. 


To determine the number of free blocks on a disk, enter the SHOW 
DEVICES command, as follows: 


$ SHOW DEVICES device-name 


The number of free blocks will be displayed under the heading Free 
Blocks. 
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1.1.6 Account Requirements 


This section. specifies the system privileges you need to install DNS, 
and the BYTLM, open file quota, and PRCLM requirements. 


1.1.6.1. Privileges 


You must have the following system privileges to install DNS: 


SYSPRV, SYSNAM, OPER, NETMBX, TMPMBX, GROUP, GRPPRYV, 
PFNMAP, PRMGBL, SHMEM, SYSGBL, SETPRV, CMKRNL. It is 
recommended that DNS be installed from the SYSTEM account. 


1.1.6.2 BYTLM Quota 


1.1.6.3 Open 


The BYTLM quota must be set to a minimum of 20,000. 
To determine the current BYTLM value, enter the following command: 
$ SHOW PROCESS/QUOTA 


The display that appears will include the heading, “Buffered I/O Byte 
Count Quota". If the value is less than 20,000, modify the record in the 
user authorization file for the system account, as follows: 


$ MCR AUTHORIZE 

UAF> MODIFY SYSTEM/BYTLM=20000 
UAF> EXIT 

$ 


You must log out and then log in again for the new value to take effect. 


File Quota 


The open file quota must be set to a minimum of 30. You can check the 
current value.of this parameter by entering the following command: 


$ SHOW PROCESS/QUOTA 


The display that appears will include the heading, "Open File Quota". 
If the value is less than 30, modify the record in the user authorization 
file for the system account, as follows: 


$ MCR AUTHORIZE 

UAF> MODIFY SYSTEM/FILLM=30 
UAF> EXIT 

$ 
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You must log out and then log in again for the new value to take effect. 


1.1.6.4 PRCLM 


The subprocess quota must be set to a minimum of 3. You can check 
the current value of this parameter by entering the following command: 


$ SHOW PROCESS/QUOTA 


The display that appears will include the heading, "Subprocess Quota". 
If the value is less than 3, modify the record in the user authorization 
file for the system account, as follows: 


$ MCR AUTHORIZE 

UAF> MODIFY SYSTEM/PRCLM=3 
UAF> EXIT 

$ 


You must log out and then log in again for the new value to take effect. 


1.1.7 System Requirements 


This section specifies system parameter values that are required to 
install DNS. 


Whenever parameter values are changed, enter the following command 
to reset the parameter values and to reboot the system so that the new 
parameter values take effect: 


$ @SYSSUPDATE:AUTOGEN GETDATA REBOOT 


For information about AUTOGEN, see the VAX/VMS System 
Manager’s Reference Manual. 


1.1.7.1. Processes 


DNS requires three process entry slots for the following detached 
processes: 


¢ DNS$TA—The transaction agent process. It communicates with 
DNS clients. 


¢ DNS$BACK—The background process. It updates copies of directo— 
ries. 
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¢ DNS$ADVER—The advertisement process. It notifies DNS clients 
that clearinghouses on DNS servers are available. 


To check the number of free process slots, enter the following command: 
$ SHOW MEMORY 


The line for Process Entry Slots and Balance Set Slots should each be 
at a minimum value of 3 in the Free column. If this is not the case, 
edit the SYS$SYSTEM:MODPARAMS DAT file to change the values of 
these parameters. 


1.1.7.2 Global Pages and Global Sections 


In order for DNS to function properly, you may need to increase the 
number of global pages and global sections (the SYSGEN parameters 
GBLPAGES and GBLSECTIONS). If the current settings for these 
parameters are inadequate, VMSINSTAL will not be able to start up 
DNS at the end of the installation procedure. 


DNS requires 334 global pages and 12 global sections. 


To check the number of available global pages and global sections, enter 
the following commands: 


$ RUN SYSS$SYSTEM: INSTALL 
INSTALL> /GLOBAL 


These commands display the system global pages and global sections. 
The last line of the display shows the number of used global sections 
and the number of used and unused global pages. To determine the 
number of unused global sections, you must exit from INSTALL (type 
/EXIT after the prompt) and invoke the SYSGEN utility as follows: 


$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> SHOW GBLSECTIONS 


These commands display the SYSGEN settings for global sections. 
The value appears under the heading Current. Subtract the used 
global sections value from the current SYSGEN value to determine the 
number of unused global sections. 


If the unused global pages and sections are not adequate for run— 
ning DNS, edit the SYS$SYSTEM:MODPARAMS.DAT file to add 
statements that increase the values of the SYSGEN GBLPAGES and 
GBLSECTIONS parameters. 
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To increase GBLPAGES and GBLSECTIONS values, add the following 
statements at the end of the SYS$SYSTEM:MODPARAMS.DAT file: 


ADD_GBLPAGES=nnn 
ADD_GBLSECTIONS=nnn 


where nnn is the number by which you are increasing the current 
setting. 


1.1.8 Installing DNS on a VAXcluster 


You can install DNS on individual members of a VAXcluster. Each 
cluster member operates as an independent DNS server. Files 
are not shared among the servers. Rather, all server files reside 
in the SYS$SPECIFIC directories. Client files are stored in the 
SYS$COMMON directories. 


If you enter the following commands before DNS is installed, you 
can assign access control rights using the cluster alias instead of the 
individual cluster node names: 

$ RUN SYSSSYSTEM: NCP 

NCP> DEFINE OBJECT DNS$TA NUMBER 44 ALIAS OUTGOING ENABLE 


NCP> SET OBJECT DNS$TA NUMBER 44 ALIAS OUTGOING ENABLE 
NCP> EXIT 


1.1.9 Installation Time Requirements 


Installation of DNS should take about 10 minutes. The installation 
verification procedure (IVP) should take about 5 minutes. 


1.2 Installing Additional DNS Servers 


If the DNS server you are installing is not the first one in the network, 
you will have to synchronize system clocks, assign access rights, and 
obtain name information, as described in the following sections. 
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1.2.1. Synchronizing System Clocks 


You must synchronize local system clock time with clock time on an 
existing DNS server. Synchronize clocks by first issuing the VMS 
SHOW TIME command for the existing server. Then issue the VMS 
SET TIME command to enter that time (plus elapsed time) on the 
system on which you are installing DNS. 


The installation procedure will fail if there is a discrepancy of more 
than 4 minutes between system clock times on DNS servers. See the 
BADCLOCK error message in Chapter 4. 


The following is a list of the time categories that you can display by 
issuing the SHOW TIME command. You can specify these values by 
issuing the SET TIME command. 


dd = day of the month (1—31) 
mmmz= month (first three letters of the month) 


YYYy = year 

hh = hour of the day (0—23) 

mm = minutes (0—59) 

ss = seconds 0—59) 

cc = hundredths of a second (0—99) 


The format for the SET TIME command is as follows: 
SET TIME = dd—mmm-yyyy hh:mm:ss.cc 


Specify values for the time parameters as required. 


1.2.2 Assigning Access Rights 
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You will find a detailed discussion of access rights in Chapter 3 of 
the VAX Distributed Name Service Management Guide. The following 
sections cover’ details of particular interest to the DNS installer. 


NOTE 


The following discussion applies to the installation of only 
the second and subsequent DNS servers in an existing 
namespace. It does not apply to installation of the first DNS 
server. 
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In assigning access rights, one of two conditions will be true: 


1. You are storing the clearinghouse object in the root directory. 


2. You are storing the clearinghouse object in a directory other than 
the root directory. 


The following sections discuss assignment of access rights under these 
conditions. In both cases, the user (expressed as node—name::user—name) 
needs read, write, delete, and control access to the directory that stores 
the clearinghouse object. 


1.2.2.1. Storing the Clearinghouse Object in the Root Directory 


If you accept the default clearinghouse name offered by the installation 
procedure, you create a clearinghouse object that is stored in the root 
directory. Therefore, DNS (node—name::DNS$SERVER) needs read, 
write, delete, and control access to the root directory in order to create 
the clearinghouse object. 


1.2.2.2 Storing the Clearinghouse Object in a Different Directory 


If you specify a name other than the default name for your clear— 
inghouse, you can place the name in a directory that is not the root. 
The clearinghouse object will be placed in the directory you specify. 
Therefore, the DNS server needs read, write, delete, and control access 
to the directory that stores the clearinghouse object. The server also 
needs read and write access to that directory’s parent directory. 


The directory that stores the clearinghouse object must be allowed to 
contain clearinghouse objects, as described in Chapter 3 of the VAX 
Distributed Name Service Management Guide. 


1.2.3. Network Information 


Obtain the following information from a DNS manager in your network. 
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1.2.3.1. Name of an Existing DNS Node 


You need to know the name of a node on which DNS is installed and 


running. Enter this name in response to the following installation 
procedure request: 


*Enter the DNS server node name: 


See the installation description in Chapter 2. 


1.2.3.2 Clearinghouse Name 


Ask other DNS managers in your network whether the DNS server you 
are installing is joining an existing namespace that has a hierarchical 
structure. If so, ask the appropriate DNS manager for the name of 
the directory that stores the clearinghouse object. Enter that directory 
name, followed by the clearinghouse name in response to the following 
installation procedure request: 


*Clearinghouse name [node-name_CH]: 
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Chapter 2 


Installation and Verification 
Procedures 


This chapter tells you how to install DNS software on nodes running 
VAX/VMS V4.4 or later or MicroVMS V4.4 or later. It also describes a 
procedure that verifies the installation. 


2.1 Preparing for Installation 


You use the VMSINSTAL procedure to install DNS. VMSINSTAL asks 
a series of questions to which you must provide appropriate responses. 
For help on any of the VMSINSTAL questions, enter a question mark 
(?) in response to the question. This displays information that should 
help you answer the question. The question is then repeated. Default 
responses appear in square brackets ([ ]). Press to accept the 
default response. 


To abort the installation procedure, press [CTRUY]. When you do so, the 


installation procedure deletes all DNS files it has created up to that 
point and exits. If you want to retry the installation procedure after 


you have pressed [CTRL], you must invoke VMSINSTAL again. See 
step 2 in Section 2.3. 


To save a copy of the VMSINSTAL session for future reference, issue 
the SET HOST 0/LOG command before using VMSINSTAL. 
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Before you install DNS, be sure that you have fulfilled all the require— 
ments described in Chapter 1. 


NOTES 


You must keep DECnet—VAX running while you install DNS. 
DNS uses DECnet-—VAX services during the installation. 


The installation procedure executes the DNS$STARTUP.COM 
file and creates a temporary batch queue named DNS$BATCH_ 
node—-name. Therefore, the queue manager must be running 
in order to install DNS. 


2.2 Getting Help 


On-line information is available to help you prepare answers to the 
DNS installation questions. To display this information, type a ques— 
tion mark (?) after any question. 


The next section presents the HELP text along with the questions 
posed by the installation procedure. Reviewing the HELP text before 
you start the installation procedure can help you prepare responses to 
the installation questions. 


2.3 The DNS Installation Procedure 
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To install DNS, follow these steps: 


Step 1. Log in to the system manager account. 


The system manager account has the privileges necessary for running 
VMSINSTAL.” 


Step 2. Invoke VMSINSTAL. 
To invoke VMSINSTAL enter this command line: 


$ @SYSS$UPDATE:VMSINSTAL DNSO11 ddcu: [OPTIONS N] 


Installation and Verification Procedures 


The value ddcu: represents the name of the device on which your 
distribution media is mounted. You can obtain this name by entering 
the following command: 


$ SHOW DEVICE 


Specifying OPTIONS N is the only way to print the release notes. If 
you do not specify OPTIONS N, the procedure automatically moves 
the release notes to SYS$HELP. It is recommended that you read the 
release notes before you start the installation. 


This following appears on the screen: 
VAX/VMS Software Product Installation Procedure Vx.x 


It is dd-mmm-yyyy at hh:mm. 
Enter a question mark (7) at any time for help. 


Step 3. Check the system environment. 


VMSINSTAL now checks your system environment and notifies you 

of any running processes. If DECnet is running, you see a warning 
message, as shown in the following sample display. Other non-system 
processes that are running are also noted, as shown in the example. If 
DECnet is not running, no messages are displayed, and the procedure 
goes directly to step 4 and fails during step 6. 


%SVMSINSTAL-W-DECNET, Your DECnet network is up and running. 
SVMSINSTAL-W-ACTIVE, The following procedures are still active: 
MAIL 38503 
JIM 


*Do you want to continue anyway [NO]? 


This display is informational. It does not mean that you should not 
continue. However, if you enter NO or press [RET] VMSINSTAL termi- 
nates and you return to system command level. If you enter YES, the 
installation continues. 


Step 4. Check backup. 


The procedure then reminds you to back up your system disk before 
you install the software: 


*Are you satisfied with the backup of your system disk [YES]? 


If you enter YES, the installation continues. If you enter NO, the 
installation terminates and you return to system command level. 
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Step 5. Mount the installation kit volume. 


The procedure now prompts you to mount the distribution volume. 
Mount the volume and make sure that the device is in the ready state. 


Enter YES and press when you are ready. A confirmation message 
tells you that the medium is mounted. 


Please mount the first volume of the set on ddeu: 
*Are you ready? 
%SMOUNT-I-MOUNTED, DNS mounted on ddcu: 


Step 6. Start the installation. 
When the installation kit volume is mounted, the following is displayed: 
The following products will be processed: 
DNS V1.1 
Beginning installation of DNS V1.1 at hh::mm 
SVMSINSTAL-I-RESTORE, Restoring product saveset A... 


If DECnet is not running, the following message is displayed and you 
return to system command level. 


DECNET is not running on this system. You must have DECNET running before 
you can install DNS. 


If you specified OPTIONS N when you invoked VMSINSTAL, the 
following is now displayed: 
Release notes options: 


1. Display release notes 
2. Print release notes 
3. Both 1 and 2 


* Select option [3]: 


It is recommended that you read the release notes before you install 
DNS. If you enter 1 or 3, VMSINSTAL displays the release notes at 
your terminal. If you enter 2 or 3, VMSINSTAL prompts you to enter a 
print queue name, as follows: 


Queue name [SYSSPRINT]: 


Enter a queue name or press [RET]. VMSINSTAL queues a copy of the 
release notes to print and displays a message such as the following: 


Job DNSO11 (queue queue, entry nnn) started on device 
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The following is then displayed: 


* Do you want to continue the installation [N]? 


Enter YES, or press to accept the default. If you enter YES, the 
procedure continues with this message: 


SVMSINSTAL-I-RELMOVED, The product’s release notes have been successfully 
moved to SYSSHELP. 


The following is then displayed: 


eoSooSSoSS SSS SS VSS SS TS TS 33 LS LSS LSS LS TS SS LS SS TS SL LS SS LS LS SS SE SSS SS LLL SL LS TSS VLE VI TS SS LS LS TS SS SSS SS SS SS ST 
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If the queue manager is not running, you will see the following mes- 
sage: 


The queue manager is stopped. It must be started to continue this 
installation. This installation procedure will exit if you do not 
want to start the queue manager. 


* Do you want to want to start the queue manager [YES]? 


If you enter YES or press [RET], the installation procedure starts the 
queue manager. If you enter NO, the following message is displayed 
and you return to system command level. 


You must have the queue manager running in order to continue with the 
installation. 


If you are re-installing DNS, the following is displayed (and the DNS 
installation questions 1-8, which follow this display, are not asked): 


A VAX Distributed Name Service exists on this system from a previous 
installation. Image, help, and message files will be updated if you 
continue. Clearinghouses file(s) will not be modified. 


If you are installing DNS on a VMS Version 5.0 (or later) system, the 
following license PAK information for DNS is displayed along with a 
question that requires you to verify that you have used the LMF utility 
to register a license PAK for DNS: 


SDNS-I-LICCHECK, Checking for DNS license on this system 
Product: DNS 

Producer: DEC 

Version: 1.1 

Release Date: 1-MAY-1988 


* Does this product have an authorization key registered and loaded? 
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You must answer YES to this question. Otherwise, the installation 
procedure exits after displaying the following message: 


You do not have the license to run this product. 
Please register the license for this product by typing the following 
command and then re-try the installation. 


@SYSSUPDATE : VMSLICENSE 


The following message is then displayed (on both VMS V4.x and V5.0 
systems): 


Most products provide an Installation Verification Procedure (IVP) 
which verifies the completeness and accuracy of the installation. 
You may wish to run the IVP immediately after installation. 


* Do you want to run the IVP after the installation [YES]? 


The Installation Verification Procedure (IVP) for DNS determines 
whether DNS is installed properly and whether basic DNS functions 
are operating properly. Press if you want to run the IVP immedi- 
ately after installation is complete. If you do not want to run the IVP 
immediately after installation, enter NO. You can run the IVP later, as 
described in the installation procedure and in Chapter 3. 


The following is then displayed: 


During this installation, new files will be provided to replace existing 
versions. You may purge these older versions to save disk space, or keep 
them if you feel they may be of use. Purging is recommended. 


* Do you want to purge files replaced by this installation [YES]? 


If you enter YES or press [RET], duplicate files will be deleted. 


NOTE 


The questions that follow are specific to the DNS server 
installation. They are labeled DNS Question 1 through 8 and 
are explained in sequence. 


VAX Distributed Name Service Site Specific Questions 


DNS Question 1. If this is the first DNS server being installed in the 


network, enter YES to the following question. Otherwise, press to 
accept the default. 


* Is this a new namespace [NO]: 
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If you enter a question mark (?), the following explanatory text is 
displayed and the question is repeated. If you enter YES, then DNS 
Question 2 is displayed; otherwise DNS Question 3 is displayed. 


If the Name Service is already installed in your network, accept the 
default answer to this question. Otherwise, create a new namespace by 
answering YES to this question. 


DNS Question 2. Enter the name of the namespace, or press to 
accept the default. The default name is the name of your node followed 
by _NS. 


* Namespace Name [node-name_NS] 


If you enter a question mark, the following explanatory text is dis— 
played and the question is repeated. 


Your namespace must have a name. 
Example: FIRM NAME 
or accept the default: 


node-name_NS 


DNS Question 3. The following question is then displayed: 
* Timezone (+hh:mm or -hh:mm): 


If you enter a question mark, you receive the following explanatory 
text: 


A timezone value is the number of hours and minutes difference between 
the time observed in this node’s timezone and Greenwich Mean Time (GMT). 


A negative {-) timezone value means that this node is west of GMT. 
A positive (+) timezone value means that this node is east of GMT. 


The range is from -12:00 to +13:00. 
The format is +thh:mm or -hh:mm, where: 


hh indicates the number of hours 
mm indicates the number of minutes 
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For example: 
Eastern Standard Time is -5:00 hours from GMT. 
Eastern Daylight Time is -4:00 hours from GMT. 
Oklahoma (Standard Time) is -6:00 hours from GMT. 
California (Standard Time) is -8:00 hours from GMT. 
Newfoundland is -3:30 hours from GMT. 
Australia Capital Territory is +10:00 hours from GMT. 
Greece is +2:00 hours from GMT. 
Japan is +9:00 hours from GMT. 
Ontario, east of longitude W.63 degrees is -4:00 hours from GMT. 
Ontario, west of longitude W.63 degrees is -5:00 hours from GMT. 
Singapore is +7:30 hours from GMT. 
India is +5:30 hours from GMT. 
Great Britain, Iceland, Portugal, Upper Volta are at GMT or 0:0. 
Great Britain, Summer Time +1:00 hours from GMT. 


DNS Question 4. Enter the name of the clearinghouse that this 


installation is creating, or press to accept the default. The default 
is the name of your node followed by _CH. 


Note that the installation stores the clearinghouse name in the 
root directory by default. If you have already created a hierarchical 
namespace, you can specify a directory in the hierarchy in which the 
clearinghouse name will be stored. For example, if you specified the 
clearinghouse name ENGINEERING.CLEARINGHOUSE, you would 
create a clearinghouse named .ENGINEERING.CLEARINGHOUSE, 
whose name would be stored in the directory ENGINEERING. 


* Clearinghouse Name [node-name_CH]: 


NOTE 


If this is not the first installation of DNS in your network 
and you accept the default answer to this question, the 
installation procedure will copy the root directory (and its 
contents) to the clearinghouse you are creating. This is true 
for any clearinghouse that you store in the root directory. In 
a single—directory namespace, this is how the root directory 
gets distributed on multiple servers. 


In a hierarchical namespace, if you specify a directory other 
than the root in which the clearinghouse name is to be 
stored, the installation procedure copies that directory (and 
its contents) to the clearinghouse you are creating. 
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If you enter a question mark, the following explanatory text is dis— 
played and the question is repeated. 


Your clearinghouse must have a name. 
Example: ENGINEERING . CLEARINGHOUSE 
where ENGINEERING is a directory that exists in your namespace. 
or accept the default: 
node-name_ CH 


This default name is a DNS name, not a VMS file specification. The 
file associated with the clearinghouse is created in the directory 
associated with the DNSSSERVER account. 


If this is not the first DNS server being installed in the network, 
you may want to review the discussion on access rights and name 
information in Chapter 1. 


DNS Question 5. Enter a user identification code (UIC), or press 
to accept the default. The default value is [371,371]. 


The following information is then displayed. 


In order to ensure that the VAX Distributed Name Service runs with the 
proper quotas, this installation procedure will create the account 
DNS$SERVER. You must specify a unique UIC for this account in order 
to ensure proper installation. 


* Enter UIC for DNS server account (include brackets) [[371,371]]: 


If you enter a question mark, the following explanatory text is dis— 
played and the question is repeated. 


In order to ensure that the VAX Distributed Name Service processes run 
with the proper quotas, privileges, and username, this installation 
procedure will create an account for the server - DNSSSERVER. 


Specify an octal group number and user number that is unique for this 
system or accept the default uic that has been provided. You must 
enclose the uic with square bracket characters. 


For example: © [371,371] 


DNS Questions 6 and 7: You must specify and verify a password for 
the DNS server account, DNS$SERVER. The following questions are 
displayed: 


* Enter password for the DNS server account: 


* Verify password for the DNS server account: 
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If you enter a question mark in response to questions 6 or 7, the 
following information is displayed: 


You must specify a password for the DNSS$SERVER account. The password 
you specify must contain at least six characters. Valid characters 
for a password are A through Z, 0 through 9, $ (dollar sign), and _ 
(underscore). 


As with the DCL SET PASSWORD command, your input will not appear on 
the terminal. To protect against typing errors you must enter the 
password twice. 


The following is then displayed: 


%DNS-I-CREACC, Creating account DNS$SERVER for the VAX DNS Server 
SVMSINSTAL-I-ACCOUNT, This installation creates an account named DNSSSERV 
%SDNS-I-CREDIR, VAX Distributed Name Service creates DNS$SERVER directory. 


DNS Question 8: Enter the name of the device on which the 


DNS$SERVER directory will reside, or press to accept the default 
name. The default disk name is SYS$SYSROOT. 


The following information is displayed: 


* Device to be used for storing DNSSSERVER files [SYS$SYSROOT]: 


If you enter a question mark, the following explanatory text is dis— 
played and the question is repeated. 


This installation procedure creates a directory "DNSSSERVER" on the disk 
you specify. The directory is used to store the clearinghouse database 
and log files. 


If the DNS$SERVER directory already exists on this disk, the following 
message is displayed: 

SDNS-I-DIREXISTS, Directory "DNSSSERVER" already exists on this disk. 
The following message are then displayed (note that the first message, 
VMSINSTAL-I-SYSDISK, appears only if you accepted the default 


name, SYS$SYSROOT, whereas the ensuing messages, VMSINSTAL-I- 
ACCOUNT are always displayed): 


VMSINSTAL-I-SYSDISK, This product creates system disk directory 
SYSSSYSROOT: [DNSSSERVER] 
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%&VMSINSTAL-I-ACCOUNT, This 
SVMSINSTAL-I-ACCOUNT, This 
%VMSINSTAL-I-ACCOUNT, This 
%VMSINSTAL-I-ACCOUNT, This 
%VMSINSTAL-I-ACCOUNT, This 
SVMSINSTAL-I-ACCOUNT, This 
%VMSINSTAL-I-ACCOUNT, This 
%VMSINSTAL-I-ACCOUNT, This 
%VMSINSTAL-I-ACCOUNT, This 


installation 
installation 
installation 
installation 
installation 
installation 
installation 
installation 
installation 


SVMSINSTAL-I-RESTORE, Restoring product 


updates an account named DNSSSERVER 
updates an account named DNSSSERVER. 
updates an account named DNSS$SERVER. 
updates an account named DNSSSERVER. 
updates an account named DNSS$SERVER. 
updates an account named DNSSSERVER. 
updates an account named DNS$SERVER. 
updates an account named DNSS$SERVER. 
updates an account named DNS$SERVER. 
saveset B... 


Moving VAX Distributed Name Service files. 
SSS SS SSS SSS SSS SSS SSS LS LSS SS IS LV SS SS SS SS LLL LS SSS SSS SS SSL SS LIS SS SS SS SS SSS SLES 


This installation has added the 


[SYSEXE ] DNSSADVER. EXE - DNS 
[SYSEXE ] DNSSBACK. EXE - DNS 
[SYSEXE] DNSSCONTROL. BIN - DNS 
[SYSEXE] DNSSCONTROL. EXE - DNS 
[SYSEXE] DNS$DISPLAY_ TREE.EXE - DNS 
[SYSEXE] DNS$ML. EXE - DNS 
[SYSEXE] DNSSSOLICIT.EXE - DNS 
[SYSEXE] DNS$TRANS . EXE - DNS 
[SYSHLP]DNS$011.RELEASE NOTES - DNS 
[SYSHLP ] DNSSHELP . HLB - DNS 
[SYSLIB] DNS$CLIENT. EXE - DNS 


(SYSLIB] DNS$LIB.EXE 


- DNS 


[SYSMGR] DNS$CHANGE DEF _FILE.COM - DNS 
[SYSMGR] DNS$CLIENT_STARTUP .COM - DNS 
[SYSMGR] DNS$CLIENT_ STOP.COM - DNS 


[SYSMGR] DNSSSTARTUP .COM 
[SYSMGR] DNS$STOP .COM 
[SYSMSG] DNSSMSG.BIN 
[SYSMSG] DNS$MSG. EXE 
{SYSTEST] DNSSIVP .COM 


- DNS 
- DNS 
- DNS 
- DNS 
- DNS 


following files: 


advertisement process. 

background process. 

management command parsing table. 
control program. 

namespace display utility. 
management listener. 

client solicitation process. 
transaction process. 

release notes. 

management help library. 

client shareable library. 

shareable library. 

change default DNS server command file. 
client startup command file. 

client shutdown command file. 
startup command file. 

shutdown command file. 

management text file. 

error message file. 

installation verification procedure. 


If you are creating a new namespace (that is, if you answered YES to 
DNS Question 1), go to the section of the procedure called "Starting 
VAX Distributed Name Service." If you are not creating a new names— 
pace (that is, if you answered NO to DNS Question 1), the following 
section is included in your installation procedure. 


VAX Distributed Name Service Client Installation 
Tt 


Installing VAX Distributed Name Service Client 


Installation 
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If a client exists on this system, you see the following text: 


A VAX Distributed Name Service Client Interface exists on this system 
from a previously installed product. 


The existing DNS client setup file, SYS$SYSTEM: DNS$DEFAULT FILE.DAT, 
will be appended to the new SYS$SYSTEM:DNS$DEFAULT FILE.DAT. 


The following DNS server nodes have been found. Select a node name 
from this list or the name of another DNS server node. 


node-namel (a.nnn) 
node-name2 (a.nnn) 


Where node—-name is the name of a node on which DNS is running, and 
a.nnn is the DECnet address of that node. 


* Enter the DNS server node name: 
If you enter a question mark, the following explanatory text is dis— 
played and the question is repeated. 


Enter the name of a node on which the DNS server software has been 
installed and is running. 


The next section is displayed in its entirety if you are creating a new 


namespace. 
Starting VAX Distributed Name Service 


Creating clearinghouse, please wait 


Clearinghouse filename device-name: [DNS$SERVER] clearinghouse~-name.DN 


Adding access to the new clearinghouse for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding access to the new clearinghouse for user SYSTEM. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


If a cluster alias exists, the following paragraph is also displayed: 


Adding access to the new clearinghouse for user SYSTEM on cluster alia 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 
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The next two paragraphs appear only if you are creating a new names— 
pace. 


Adding access to the root directory for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding DEFAULT access to the root directory for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


The following post-installation instructions are displayed. Note that 
on VMS Version 5.0 systems, the SYS$MANAGER:SYSTARTUP.COM 
procedure is named SYS$MANAGER:SYSTARTUP_V5.COM. 


SSS SSS SSS SS SS SS LS TS LS LS TS TV LS TS VE LS LS ISS SS TS SV SS STS STS SSS SS SL SSSSCecCclSLS LS LPL SS TS LS LSS LS TS ST SSS 
VAX Distributed Name Service Post-Installation Instructions 
SSS LS SL Ll BS LSS LSS SS SS LS SS LS LLL LS LSaLVIVeLSSTS IVS LS SL LS TS TS VL TS TS LS LL LL LS TS LV TS LTE LV TTS VS LS LS TV TS TSS ST__SIS TSS TT 


Add a call to execute the DNS startup command procedure 

SYSSMANAGER: DNSSSTARTUP.COM from the site specific startup command 
procedure SYSSMANAGER:SYSTARTUP.COM. This command must follow the 
STARTNET.COM and the START/QUEUE/MANAGER so that DECnet and the queue 
manager start before the DNS server. 


DNS startup installs shareable libraries and global sections, creates 
permanent detached processes, and adds DECnet objects. 


To implement the "DNSCP" command, which executes the DNS 
Control Program, the following command line should be added to the 
system login command file (filename = SYSSMANAGER: SYSLOGIN.COM) : 


$ DNSCP :== SDNSSCONTROL !Foreign command to run DNS utility. 


You can run the installation verification procedure at any 
time by typing: 


$ @SYSS$TEST: DNSSIVP 


There are two DECnet event classes associated with this product, they 
are events 352 and 353. The following commands are included in 
DNSS$STARTUP .COM: 


$ NCP SET KNOWN LOGGING EVENTS 352.* 
$ NCP SET KNOWN LOGGING EVENTS 353.1,2,3,4 


If VMS V4.6 or V4.7 is running on your system the following is dis— 
played (on VMS V5.0 systems, you must re-install DNS): 


This system is running VAX/VMS Version 4.6 or 4.7. 


Please re-install DNS when you upgrade your system to 
VMS Version 5.x. : 
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If you indicated that you wanted to run the Installation Verification 
Procedure (IVP), the following is displayed: 


SSS SSS SESS SL LS LS LE SSS VS SS SSS SS SSS SSS SS LSS SS SS SS SS SS LS LS SS SS SS LSS SS SSS 


VAX Distributed Name Service Installation Verification Procedure 


The IVP issues the DNS$CONTROL commands indicated by DNSCP in 
the following example. Appendix B contains sample output of the IVP. 


DNSCP SHOW CHARACTERISTICS CLEARINGHOUSE ch-name 


In this command, ch—name is the name of the clearinghouse that you 
specified during this installation. If the SHOW command is successful, 
the IVP displays the name of the directory stored in the specified clear— 
inghouse. Clearinghouse attributes are defined in the VAX Distributed 
Name Service Management Guide. 


The IVP then enters the following command: 
DNSCP CREATE GROUP node-name_DNS$IVP 


If you created a clearinghouse in a directory other than the root, the 
directory name precedes node—name_DNS$IVP. 


If the CREATE command is successful, the IVP displays the unique 
identification number (UID) of group DNS$IVP. 


The IVP then enters the following commands: 
DNSCP ADD MEMBER node-name::SYSTEM GROUP node-name_ DNS$IVP 


If the ADD command is successful, the IVP adds the member node- 
name::SYSTEM to the group node—name_DNS$IVP. 


DNSCP SHOW CHARACTERISTICS GROUP node-name_DNS$IVP 


If the SHOW command is successful, the IVP displays the name of the 
member in the group node—name_DNS$IVP. The following command is 
then entered by the IVP: 


DNSCP DELETE GROUP node-name_DNS$IVP 


If the DELETE command is successful, the IVP exits and the following 
is displayed: 
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Installation of Distributed Name Service V1.1 successful 


Installation of DNS V1.1 completed at time 


VMSINSTAL procedure done at hh:mm 


If any of the commands entered by the IVP are not successful, then 
one or more of the error messages described in Chapter 4 is displayed. 
Take the appropriate action to correct the error. Then rerun the IVP by 
entering the following command: 


$ @SYSSTEST: DNSS$IVP 
When the IVP is successful, DNS is available for use. 
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Chapter 3 
Postinstallation Procedures 


This chapter describes procedures that you can perform after DNS is 
installed. 


3.1 Modifying Access 


The DNS installation procedure assigns access rights as follows: 


¢ If you are creating a new namespace, an access control entry 
is added to the root directory and to the clearinghouse you are 
creating. This gives all users all rights to the directory. 


e If you are not creating a new namespace, all users are given all 
access rights to the clearinghouse being created. 


You can examine access to directories by issuing the following 
DNS$CONTROL command: 


SHOW ACCESS DIRECTORY dir—name 
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3.1.1. Modifying Access Rights to a New Namespace 


In addition to giving an access control entry for a new namespace, 
the installation procedure also adds an access control entry that is 
propagated to all objects in the root directory. This gives all users all 
rights to the objects. 


In the following DNS$CONTROL commands, which the installation 
procedure issues, *::* specifies all users, and the dot (.) specifies the 
root directory. 


ADD ACCESS *::* DIR . /RIGHT=(READ, WRITE, DELETE, TEST, CONTROL) 
ADD ACCESS *::* DIR . /FLAGS=(DEFAULT) /RIGHT= (READ, WRITE, DELETE, TEST, CONTROL) 


To assign specific access rights to specific individuals and groups, first 
remove these entries using the following DNS$CONTROL commands: 


DNS> REMOVE ACCESS *::%* DIR ./RIGHT=(READ, WRITE, DELETE, TEST, CONTROL) 
DNS> REMOVE ACCESS *::* DIR ./FLAGS= (DEFAULT) 
/RIGHT= (READ, WRITE, DELETE, TEST, CONTROL) 


Then use the ADD ACCESS command to assign access rights as 
required. 


3.1.2 Modifying Access Rights to an Existing Namespace 


The installation procedure issues the DNS$CONTROL ADD ACCESS 
command in the following format to give access rights to the clearing- 
house that is created when you install a DNS server in an existing 
namespace. 


ADD ACCESS *::* CLEAR ch-name /RIGHT=(READ,WRITE,DELETE, 
TEST,CONTROL) 


To assign specific access rights to specific individuals and groups, first 
remove these entries using the following DNS$CONTROL command: 


REMOVE ACCESS *::* CLEAR ch-—name 


Then use the ADD ACCESS command to assign the appropriate access 
rights. 
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3.2 Modifying Event Logging 


Event logging is usually turned on when DECnet is started. 

Then, during DNS installation, the DNS start-up procedure 
(DNS$STARTUP.COM) issues the following Network Control Program 
(NCP) commands: 


SET KNOWN LOGGING EVENT 352.* 
SET KNOWN LOGGING EVENT 353.1,2,3,4 


These commands enable the specified events for all logging components. 
You must then turn on the components for which you want to log 
events. Do so by issuing the following NCP command: 


SET LOGGING component STATE ON 


The meaning of event codes is described in the VAX Distributed Name 
Service Management Guide. 


3.3 Initializing Caches on Client Nodes 


Installation of a DNS server creates a file called SYS$LIBRARY:DNS$NS_ 
DEF_FILE.DAT. This file contains the namespace name and UID, the 
clearinghouse name and UID, and the node address of the DNS server. 
This file exists on DNS servers only; it does not exist on clients. 


The following is an example cf the information recorded in this file: 


namespace nickname=PEACHTREE 

namespace uid=000400fe50A0aaf95f£54de8e00 
clearinghouse name=nodex_ch 

clearinghouse uid=aa000400fe50a2aa496£E66de8e00 
clearinghouse address=aa-00-04-00-fe-50 


The file is copied during installation of applications that use DNS. It 
is copied to SYS$SYSTEM:DNS$DEFAULT_FILE.DAT on the system 
where the application is being installed and is used to initialize the 
DNS client cache. 


It is important that this file remain world readable so that the installa— 
tion of applications will not fail. 
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Such files from several DNS servers can be appended together to 
enable multiple clearinghouses to be loaded into the client’s cache at 
startup. Using the multicast capability, clearinghouses are added to the 
DNS client’s cache from DNS servers that are on the same Ethernet 
as the client. If there are no DNS servers on the same Ethernet 

as the DNS client, then appending extra SYS$LIBRARY:DNS_ 
DEF_FILE.DAT files from other DNS servers to the DNS client’s 
SYS$SYSTEM:DNS$DEFAULT_FILE.DAT file will help the client find 
an available DNS server during startup. 


The client uses the first namespace name in the file as the de- 
fault. If the client needs access to another namespace, then ad-— 
ditional SYS$LIBRARY:DNS$NS_DEF_FILE.DAT files from DNS 
server nodes in the other namespace must be appended. Entries 
from that namespace must be referenced by prefixing the appropri- 
ate namespace name to the entry name. For example in the name, 
PEACHTREE:.APPLE.SAUCE.CAKE, PEACHTREE.:. is the prefixed 
namespace name. 


3.4 Starting DNS Automatically 


You can edit your local system start-up command file (SYSTARTUP.COM) 
to invoke the DNS command file (DNS$STARTUP.COM) when the 
system is started. 


NOTE 


On VMS Version 5.0 systems, the SYSTARTUP.COM proce- 
dure is named SYSTARTUP_V5.COM. 


To do this, simply add the following statement after the statement that 
invokes the DECnet start-up command file (STARTNET.COM) and the 
START/QUEUE/MANAGER statement: 


$ @SYSSMANAGER: DNS$SSTARTUP .COM 


The position of this statement (in the SYSTARTUP.COM file) is impor- 
tant because DECnet software and the queue manager must be started 
before the DNS software. 


NOTE 


Be careful with batch jobs for DECnet startup. If DECnet 
startup is in batch, DNS startup must occur later in the 
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same batch stream to ensure that DNS starts after DECnet 
starts. 


The following sample portion of a SYSTARTUP.COM file shows the 
statement that invokes the DNS start-up command file. This state— 
ment executes the DNS$STARTUP command procedure in your 
SYS$MANAGER directory. 


§ IF FSSEARCH ("SYS$SYSTEM:NETACP.EXE") .NES. ""_ 
THEN @SYSS$MANAGER: STARTNET.COM 


$ !Command procedure to start up DNS 


$ IF FSSEARCH ("SYSSMANAGER:DNS$STARTUP.COM") .NES. ""_ 
THEN @SYSSMANAGER: DNSS$STARTUP .COM 


3.5 Stopping DNS 


Invoking the SYS$MANAGER:DNS$STOP.COM command file will stop 
the DNS server, but it will not stop a DNS client. To stop a DNS client, 
enter the following command: 


$ @SYSS$MANAGER: DNSSCLIENT STOP.COM 


This command file resides on both DNS server and client nodes. 


3.6 Installation Verification Procedure 


You can run the Installation Verification Procedure (IVP) as part of 
the installation procedure. You can also invoke the IVP from the DCL 
prompt. 


For example, if the IVP is not successful during installation, you 
can make the ‘required corrections and then rerun it by entering the 
following command: 


$ @SYSSTEST:DNSSIVP .COM 
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3.7 If Startup Fails 


When DNS starts, a batch queue is created and a batch job is sub- 
mitted to start the DNS processes. A log file named DNS$START_ 
PROCESS.LOG is created in the directory associated with the 
DNS$SERVER account. If the installation fails, examine this file 
for information that will help determine the cause of the failure. 
The directory associated with the DNS$SERVER account is named 
DNS$SERVER. It resides on the disk that you specified during the 
installation dialogue. 
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Chapter 4 
Error Handling 


This chapter alphabetically lists error messages that may be issued by 
the DNS installation procedure. 
%DNS—E-ACCESSDENIED, No rights to perform requested operation 


Explanation: The user does not have the appropriate access rights to 
perform the requested operation. 


User Action: Ask a DNS manager for the appropriate access to the 
entry. 
%DNS-E-BADCLOCK, DNS server clocks not synchronized 


Explanation: The GMT difference in DNS server clocks is greater 
than four minutes. 


User Action: Reset one or more DNS server clocks or timezones. 


%DNS-E-CLEARINGHOUSEDOWN, Clearinghouse is not available 


Explanation: A requested clearinghouse is present at the DNS server 
but is not currently available. 


User Action: Start the clearinghouse by issuing the DNS$CONTROL 
START CLEARINGHOUSE command. 


%DNS-E-CLERKBUG, Bug, submit an SPR 
Explanation: A bug was encountered in the client interface. 


User Action: Submit a Software Performance Report. 
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%DNS-E-DATACORRUPTION, DNS server is unable to access clearinghouse 
datafile 


Explanation: An error occurred while accessing the data stored at a 
clearinghouse. . 


User Action: Issue the a DNS$CONTROL REBUILD CLEARINGHOUSE 
command, or use a backup copy of the clearinghouse, if available. Refer 
to the DECnet event log for more information on the cause of the error. 


%DNS-E-ENTRYEXISTS, Creation not possible, entry already exists 


Explanation: This entry cannot be created because either an entry of 
the same name already exists in the namespace or a directory of the 
same name is in the process of being deleted. 


User Action: Reenter the command with another name. 


%DNS-E-GBLSECERROR, Error accessing DNS$GLOBAL section 


Explanation: The DNS server global section, 
SYS$SYSTEM:DNS$GLOBAL.GBL, is not mapped. 
The DNS server was not started at this node. 


User Action: Invoke the DNS$STARTUP command file to start the 
DNS server. 


%DNS—-E-INVALIDNAME, Invalid name 
Explanation: The name of the entry was formed improperly. 


User Action: Reenter the command with the correct syntax. 


%DNS-E-NAMESERVERBUG, Bug, submit an SPR 
Explanation: A bug was encountered in the DNS server. 


User Action: Submit a Software Performance Report. 


4—2 Error Handling 


%DNS—-E-NOCOMMUNICATION, Unable to communicate with DNS server 


Explanation: It was impossible to communicate with a DNS server 
capable of processing the request. Any of the following may have been 
the cause: 


¢ It was impossible to establish a DECnet link. 

¢ The DNS server was not operating. 

¢ Aclearinghouse containing a copy of the directory needed to store 
the new clearinghouse information was stopped. 


User Action: Make sure that: 


¢ The remote DNS server is running . 


¢ You can establish a DECnet connection to the remote DNS server 
node. 


e All clearinghouses containing a copy of the directory used to store 
the new clearinghouse information are on. 


%DNS—-E-NONSRESOURCES, Insufficient resources at DNS server 


Explanation: Resources required to process the request are not 
available at the DNS server. 


User Action: Verify that the DNS server has adequate resources. 


%DNS-E-NOTCHDIRECTORY, The parent directory is not a clearinghouse 
directory 


Explanation: Clearinghouses can be stored only in a directory 
that is allowed to store clearinghouse objects (that is, it has the 
DNS$InCHName attribute set to 1). 


User Action: To allow a directory to store clearinghouse objects, 
use the DNS$¢CONTROL SET DIRECTORY directory—name ALLOW 
command. 


%DNS—-E-POSSIBLECYCLE, Loop detected in link or group entry 


Explanation: A loop was detected in a chain of links or groups. Two 
or more groups have each other as members. 


User Action: Issue the DNS$CONTROL SHOW LINK command to 
follow the chain of links or groups. Remove the entry that is causing 
the loop. 
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%DNS-E-UNKNOWNENTRY, Requested entry does not exist 


Explanation: The requested entry does not exist in the namespace, 
the user does not have access to the entry, or the entry is being deleted. 


User Action: If the entry exists and you do not have proper access to 
it, you will need to acquire access rights to the directory that contains 
the entry and reinstall DNS. 


4-4 Error Handling 


Appendix A 


Files Affected by DNS Installation 


The following files (listed alphabetically) are in save set A of the DNS 


medium: 

File Function 
DNS$011.RELEASE_NOTES DNS release notes 
KITINSTAL.COM DNS kit installation proce— 


dure 


Files Affected by DNS installation A-1 


The following files (listed alphabetically) are in save set B of the DNS 


medium: 
File Function 
DNS$ADVER.EXE DNS advertisement process 
DNS$BACK.EXE DNS background process 
DNS$CHANGE_DEF_FILE.COM DNS change default DNS 
server command file 
DNS$CLIENT.EXE DNS client shareable library 
DNS$CLIENT_STARTUP.COM DNS client start-up command 
file 
DNS$CLIENT_STOP.COM DNS client shutdown com- 
mand file 
DNS$CONTROL.BIN DNS management command 
parsing table 
DNS$CONTROL.EXE DNS control program 
DNS$DISPLAY_TREE.EXE DNS namespace display 
utility 
DNS$HELP.HLB DNS management help 
library 
DNS$IVP.COM DNS installation verification 
procedure 
DNS$LIB.EXE DNS shareable library 
DNS$ML.EXE DNS management listener 
DNS$MSG.BIN DNS management text file 
DNS$MSG.EXE DNS error message file 
DNSS$SOLICIT.EXE DNS client solicitation pro- 
cess 
DNS$STARTUP.COM DNS start-up command file 
DNS$STOP.COM DNS shutdown command file 
DNS$TRANS.EXE DNS transaction process 


The installation procedure tells you when these files are moved to your 
system. 


A-2 Files Affected by DNS Installation 


The following files are created by the installation procedure. 


SYS$SYSTEM:DNS$GLOBAL.GBL 
SYS$SYSTEM:DNS$GLOBAL_CACHE.GBL 
SYS$LIBRARY:DNS$NS_DEF_FILE.DAT 
SYS$SYSTEM:DNS$DEFAULT_FILE.DAT 
ddcu:[DNS$SERVER]ch-name.DNS 
ddcu:[DNS$SERVER]ch—name.GBL 


Files Affected by DNS Installation A-3 


Appendix B 


Sample Installation Dialogues for 
VMS Version 4.6 and Version 4.7 
Systems 


This appendix contains two sample installation dialogues. Section B.1 
shows the dialogue generated by installation of the first DNS server 
in a network. This installation creates a namespace. Note that the 
answer to the question "Is this a new namespace [NO]?" is YES. 


Section B.2 shows the dialogue generated by installation of a DNS 
server in an existing namespace. Note that the answer to the question, 
"Is this a new namespace [NO]?" is NO (the default). 


B.1 Sample Installation Dialogue: New Namespace 


$ @SYSSUPDATE: VMSINSTAL DNSO11 muAO: [RET 
VAX/VMS Software Product Installation Procedure V4.7 


It is 6-APR-1988 at 15:24. 
Enter a question mark (?) at any time for help. 


SVMSINSTAL-W-DECNET, Your DECnet network is up and running. 
* Do you want to continue anyway [NO]? YES — 
* Are you satisfied with the backup of your system disk [YES]? 
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Please mount the first volume of the set on MUAO:. 
* Are you ready? YES 
SMOUNT-I-MOUNTED, DNS mounted on _APPLESMUAO: 
The following products will be processed: 
DNS v1.1 
Beginning installation of DNS V1.1 at 15:25 
$VMSINSTAL-I-RESTORE, Restoring product saveset A... 
%VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved to SYSSHEI 


VAX Distributed Name Service Installation. 
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Most products provide an Installation Verification Procedure (IVP) 
which verifies the completeness and accuracy of the installation. 
You may wish to run the IVP immediately after installation. 

* Do you want to run the IVP after the installation [YES]? 


During this installation, new files will be provided to replace existing 
versions. You may purge these older versions to save disk space, or keep 
them if you feel they may be of use. Purging is recommended. 

* Do you want to purge files replaced by this installation [YES]? 


SScolcSSS SSS SSS TS SS SS SS LS LS LS TS LS SS SS LS LS TS LS LL SS SS SSS SSS SSS LSS LS LS LSS SS SR SS SS SS LS SSS SS SS SSS LS SS 


VAX Distributed Name Service Site Specific Questions 


Is this a new namespace [NO]? YES 
Namespace Name [APPLE_NS]: 


Timezone (+hh:mm or ~hh:mm): 74: 0 fren] 
RET 


Clearinghouse Name [APPLE CH]: 


e+ + 


In order to ensure that the VAX Distributed Name Server runs with the 
proper quotas, this installation procedure will create the account 
DNSS$SERVER. You must specify a unique UIC for this account in order 
to ensure proper installation. 


* Enter UIC for DNS server account (include brackets) [[371,371]]: [RET 
* Enter password for the DNS server account: password 
* Verify password for the DNS server account: password 


%SDNS-I-CREACC, Creating account DNSS$SSERVER for the VAX DNS server 
S$VMSINSTAL-I-ACCOUNT, This installation creates an account named DNSSSERVER. 
%SDNS-I-CREDIR, VAX Distributed Name Service creates DNSSSERVER directory 

* Device to be used for storing DNSSSERVER files [SYS$SYSROOT]: DUAL [RET] 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSS$SERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNS$SERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-~I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-~I-RESTORE, Restoring product saveset B... 
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Moving VAX Distributed Name Service files. 


This installation has added the following files: 


[SYSEXE] DNSSADVER.EXE - DNS advertisment process. 
[SYSEXE ] DNSSBACK . EXE - DNS background process. 

[SYSEXE] DNSSCONTROL.BIN - DNS management command parsing table. 
[SYSEXE] DNSSCONTROL. EXE - DNS control program. 

[SYSEXE] DNS$DISPLAY_TREE.EXE - DNS namespace display utility. 
[SYSEXE] DNS$SML. EXE - DNS management listener... 
[SYSEXE] DNSSSOLICIT.EXE - DNS client solicitation process. 
[SYSEXE] DNS$TRANS. EXE - DNS transaction process. 
[SYSHLP] DNS$011.RELEASE NOTES - DNS release notes. 

[SYSHLP ] DNSSHELP . HLB - DNS management help library. 
[SYSLIB] DNSSCLIENT. EXE - DNS client shareable library. 
[SYSLIB] DNS$LIB.EXE - DNS shareable library. 


[SYSMGR] DNS$CHANGE_DEF_FILE.COM- DNS change default server command file 
[SYSMGR]DNS$CLIENT STARTUP .COM DNS client startup command file. 
[SYSMGR] DNS$CLIENT_ STOP.COM DNS client shutdown command file. 


[SYSMGR] DNS$STARTUP .COM - DNS startup command file. 

[SYSMGR] DNSSSTOP .COM - DNS shutdown command file. 

[SYSMSG] DNSSMSG.BIN - DNS management text file. 

[SYSMSG] DNS$MSG. EXE - DNS error message file. 

[SYSTEST]DNSSIVP .COM - DNS installation verification procedure. 
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Starting VAX Distributed Name Service 
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Creating clearinghouse, please wait 
Clearinghouse filename DUAL: [DNS$SERVER] apple_ch.DNS 
*SRUN-S-PROC ID, identification of created process is 00000183 


Adding access to the new clearinghouse for all users on all nodea. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding access to the new clearinghouse for user SYSTEM. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding access to the root directory for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding DEFAULT access to the root directory for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


VAX Distributed Name Service Post-Installation Instructions 
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Add a call to the DNS startup command procedure SYSSMANAGER: DNS$STARTUP.COM 
to the site specific startup command procedure SYS$MANAGER:SYSTARTUP .COM. 
This command must follow the STARTNET.COM and the START/QUEUVE/MANAGER, so 
that DECnet and the queue manager start before the DNS server. 
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DNS startup installs shareable libraries and global sections, creates 
permanent detached processes, and adds DECnet objects. 


To implement the "DNSCP" command, which executes the DNS server 
Control Program, the following command line should be added to the system 
login command file (filename = SYSS$MANAGER: SYLOGIN.COM) : 


$ DNSCP :== SDNSSCONTROL {Foreign command to run DNS utility. 


You can run the installation verification procedure at any time by 
typing: 


$ QSYSSTEST: DNSSIVP 


There are two DECnet event classes associated with this product, they 
are events 352 and 353. The following commands are included in 
DNSSSTARTUP .COM: 


$ NCP SET KNOWN LOGGING EVENTS 352.* 
$ NCP SET KNOWN LOGGING EVENTS 353.1,2,3,4 
This system is running VAX/VMS Version 4.6 or 4.7. 


Please re-install DNS when you upgrade your system to 
VMS Version 5.x. 
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VAX Distributed Name Service Installation Verification Procedure 
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DNSCP SHOW CHARACTERISTICS CLEARINGHOUSE APPLE CH 
Directory APPLE NS:. 


DNSCP CREATE GROUP APPLE DNS$IVP 
UID aa-00-04-00-97-11-a0-7c-9e-58-5a-0£-91-00 


DNSCP ADD MEMBER APPLE::SYSTEM GROUP APPLE DNS$IVP 


DNSCP SHOW CHARACTERISTICS GROUP APPLE DNSS$IVP 
Member apple::system (APPLE NS: .DNS$IV.apple. system) 


DNSCP DELETE GROUP APPLE DNS$IVP 
Installation of Distributed Name Service V1.1 successful. 
Installation of DNS V1.1 completed at 15:34 


VMSINSTAL procedure done at 15:34 
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B.2 Sample Installation Dialogue: Existing Namespace 


$ @SYSSUPDATE: VMSINSTAL DNSO11 MUAO: [RET 


VAX/VMS Software Product Installation Procedure V4.7 
It is 6-APR-1988 at 16:35. 
Enter a question mark (7) at any time for help. 


SVMSINSTAL-W-DECNET, Your DECnet network is up and running. 
* Do you want to continue anyway [NO]? YES 
* Are you satisfied with the backup of your system disk [YES]? 


Please mount the first volume of the set on MUAO:. 
* Are you ready? YES 
%SMOUNT-I-MOUNTED, DNS mounted on _APPLESMUAO: 
The following products will be processed: 
DNS V1.1 
Beginning installation of DNS V1.1 at 16:37 
SVMSINSTAL-I-RESTORE, Restoring product saveset A... 
SVMSINSTAL-I-RELMOVED, The products release notes have been successfully moved to SYSS$HELP. 


VAX Distributed Name Service Installation. 
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Most products provide an Installation Verification Procedure (IVP) 
which verifies the completeness and accuracy of the installation. 
You may wish to run the IVP immediately after installation. 

* Do you want to run the IVP after the installation [YES]? 


During this installation, new files will be provided to replace existing 
versions. You may purge these older versions to save disk space, or keep 
them if you feel they may be of use. Purging is recommended. 

* Do you want to purge files replaced by this installation [YES]? 


VAX Distributed Name Service Site Specific Questions 


* Is this a new namespace [NO]? 
Timezone (+hh:mm or -hh:mm): -4:00 
* Clearinghouse Name [APPLE CH]: [RET 


+ 


In order to ensure that the VAX Distributed Name Server runs with the 
proper quotas, this installation procedure will create the account 
DNSSSERVER. You must specify a unique UIC for this account in order 
to ensure proper installation. 


* Enter UIC for DNS server account (include brackets) [[371,371]]: |RET 
* Enter password for the DNS server account: password 


* Verify password for the DNS server account: password 
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%DNS-I-CREACC, Creating account DNSSSERVER for the VAX DNS server 
SVMSINSTAL-I-ACCOUNT, This installation creates an account named DNSSSERVER. 
%DNS-I-CREDIR, VAX Distributed Name Service creates DNSSSERVER directo 

* Device to be used for storing DNSSSERVER files [SYSS$SYSROOT]: DUAL 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
%SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSS$SERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSS$SERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-~I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an account named DNSSSERVER. 
%VMSINSTAL-I-RESTORE, Restoring product saveset B... 
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Moving Distributed Name Service files. 
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This installation has added the following files: 


[SYSEXE] DNSSADVER.EXE - DNS advertisment process. 
[SYSEXE] DNSSBACK.EXE - DNS background process. 

[SYSEXE] DNSS$CONTROL. BIN - DNS management command parsing table. 
[SYSEXE] DNSSCONTROL. EXE - DNS control program. 

[SYSEXE] DNS$DISPLAY_TREE.EXE - DNS namespace display utility. 
[SYSEXE] DNS$ML. EXE ~ DNS management listener.. 
[SYSEXE] DNSSSOLICIT.EXE - DNS client solicitation process. 
[SYSEXE] DNSSTRANS . EXE - DNS transaction process. 
{[SYSHLP] DNS$011.RELEASE NOTES - DNS release notes. 

[SYSHLP] DNSSHELP .HLB - DNS management help library. 
[SYSLIB] DNS$CLIENT. EXE - DNS client shareable library. 
[SYSLIB] DNSS$LIB.EXE - DNS shareable library. 


[SYSMGR] DNS$CHANGE_ DEF _FILE.COM- DNS change default server command file 
[SYSMGR] DNSS$CLIENT STARTUP .COM - DNS client startup command file. 


[SYSMGR] DNS$CLIENT_STOP .COM - DNS client shutdown command file. 

[SYSMGR] DNSSSTARTUP .COM - DNS startup command file. 

[SYSMGR] DNSSSTOP .COM - DNS shutdown command file. 

[SYSMSG] DNS$MSG.BIN - DNS management text file. 

[SYSMSG] DNS$MSG.EXE ~ DNS error message file. 

(SYSTEST] DNSSIVP .COM - DNS installation verification procedure. 
VAX Distributed Name Service Client Installation 


Installing VAX Distributed Name Service Client 


A VAX Distributed Name Service Client Interface exists on this system 
from a previously installed product. 


The existing DNS client setup file, SYS$SYSTEM: DNS$DEFAULT_FILE.DAT, 
will be appended to the new SYSS$SYSTEM: DNS$DEFAULT FILE.DAT 


B-6 Sample Installation Dialogues for VMS Version 4.6 and Version 4.7 Systems 


/ 


The following DNS server nodes have been found. Select a node name 
from this list or the name of another DNS server node. 


APPLE (4.407) 

* Enter the name of an existing DNS server node: PLAPEN 

%COPY~-S-COPIED, PLAPEN: :SYS$SYSROOT: [SYSLIB] DNS$NS_DEF_FILE.DAT;4 copied to 
VMI$ROOT: [SYSUPD.DNS011] DNS$DEFAULT FILE.DAT;1 (1 block) 

%SAPPEND-S-APPENDED, VMIS$SPECIFIC: [SYSEXE] DNS$DEFAULT_FILE.DAT;105 appended to 
VMI$ROOT: [SYSUPD.DNS011] DNS$DEFAULT FILE.DAT;1 (5 records) 

SRUN-S-PROC_ID, identification of created process is 000001A3 
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Starting VAX Distributed Name Service 


SS 
Creating clearinghouse, please wait 
Clearinghouse filename DUAL: [DNS$SERVER] apple_ch.DNS 


Adding access to the new clearinghouse for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding access to the new clearinghouse for user SYSTEM. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 
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VAX Distributed Name Service Post-Installation Instructions 
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Add a call to the DNS startup command procedure SYSSMANAGER: DNS$STARTUP.COM 
to the site specific startup command procedure SYSSMANAGER:SYSTARTUP .COM. 
This command must follow the STARTNET.COM and the START/QUEUE/MANAGER, so 
that DECnet and the queue manager start before the DNS server. 


DNS startup installs shareable libraries and global sections, creates 
permanent detached processes, and adds DECnet objects. 


To implement the "DNSCP" command, which executes the DNS server 
Control Program, the following command line should be added to the system 
login command file (filename = SYSSMANAGER:SYLOGIN.COM) : 


$ DNSCP :== $DNSSCONTROL !Foreign command to run DNS utility. 


You can run the installation verification procedure at any time by 


typing: 
$ @SYS$TEST: DNSSIVP « 


There are two DECnet event classes associated with this product, they 
are events 352 and 353. The following commands are included in 
DNSSSTARTUP,COM: 


$ NCP SET KNOWN LOGGING EVENTS 352.* 
$ NCP SET KNOWN LOGGING EVENTS 353.1,2,3,4 


This system is running VAX/VMS Version 4.6 or 4.7. 


Please re-install DNS when you upgrade your system to 
VMS Version 5.x. 
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VAX Distributed Name Service Installation Verification Procedure 


SSS SV SSS SS SSS SI SS TS ST SSS TS SS TV VS SV TV SS SS SSS TSS TS SS SS LS VS LS SSS SS SS VS LS LS SS LS SS SS SS SE = 


DNSCP SHOW CHARACTERISTICS CLEARINGHOUSE APPLE _CH 
Directory PLAPEN _NS:. 


DNSCP CREATE GROUP APPLE _DNSS$IVP 
UID aa-00-04-00-56-12-70-65-1d-1b-65-0f-91-00 
DNSCP ADD MEMBER APPLE: : SYSTEM GROUP APPLE DNS$IVP 
DNSCP SHOW CHARACTERISTICS GROUP APPLE DNS$IVP 
Member _—s—s apple::system (PLAPEN NS: .DNSS$IV.apple.system) 
DNSCP DELETE GROUP APPLE DNSS$IVP 
Installation of Distributed Name Service V1.1 successful. 
Installation of DNS V1.1 completed at 16:49 
VMSINSTAL procedure done at 16:50 
$ 
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Appendix C 


Sample Installation Dialogues for 
VMS Version 5.0 Systems 





This appendix contains two sample installation dialogues. Section B.1 
shows the dialogue generated by installation of the first DNS server 
in a network. This installation creates a namespace. Note that the 
answer to the question "Is this a new namespace [NO]?" is YES. 


Section B.2 shows the dialogue generated by installation of a DNS 
server in an existing namespace. Note that the answer to the question, 
"Is this a new namespace [NO]?" is NO (the default). 


C.1 Sample Installation Dialogue: New Namespace 


$ @SYSSUPDATE: VMSINSTAL DNSO11 MUAQ: RET 
VAX/VMS Software Product Installation Procedure V5.0 


It is 6-APR-1988 at 15:32. 
Enter a question mark (7?) at any time for help. 


SVMSINSTAL~W-DECNET, Your DECnet network is up and running. 
* Do you want to continue anyway [NO]? YES 
* Are you satisfied with the backup of your system disk [YES]? 


Please mount the first_volume of the set on MUAO:. 
* Are you ready? YES 
%SMOUNT-I-MOUNTED, DNS mounted on _PLAPENSMUAO: 
The following products will be processed: 
DNS v1.1 . 
Beginning installation of DNS V1.1 at 15:32 


*%VMSINSTAL-I-RESTORE, Restoring product saveset A... 
SVMSINSTAL-I-RELMOVED, The product’s release notes have been successfully moved to 
SYSSHELP. 
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VAX Distributed Name Service Installation. 
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%SDNS-I-LICCHECK, Checking for DNS license on this system 


Product: DNS 
Producer: DEC 
Version: 1.1 


Release Date: 1-MAY-1988 
* Does this product have an authorization key registered and loaded? YES 


Most products provide an Installation Verification Procedure (IVP) 
which verifies the completeness and accuracy of the installation. 
You may wish to run the IVP immediately after installation. 


* Do you want to run the IVP after the installation [YES]? 


During this installation, new files will be provided to replace existing 
versions. You may purge these older versions to save disk space, or keep 
them if you feel they may be of use. Purging is recommended. 


* Do you want to purge files replaced by this installation [YES]? 


VAX Distributed Name Service Site Specific Questions 
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Is this a new namespace [NO]? YES 
Namespace Name [PLAPEN NS]: 
Timezone (+hh:mm or -hh:mm): -4:00 
Clearinghouse Name [PLAPEN CH]: [RET 


+ + 4 + 


In order to ensure that the VAX Distributed Name Server runs with the 
proper quotas, this installation procedure will create the account 
DNSSSERVER. You must specify a unique UIC for this account in order 
to ensure proper installation. 


* Enter UIC for DNS server account (include brackets) [[{371,371]]}: (RET 
* Enter password for the DNS server account: password 
* Verify password for the DNS server account: password 


%DNS-I-CREACC, Creating account DNSSSERVER for the VAX DNS server. 
SVMSINSTAL-I-ACCOUNT, This installation creates an ACCOUNT named DNSSSERVER. 
%DNS-I-CREDIR, VAX Distributed Name Service creates DNS$SERVER directory 


* Device to be used for storing DNS$SERVER files [SYS$SYSROOT]: DUA1 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNS$SERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL~I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSS$SERVER. 
‘SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSS$SERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSS$SERVER. 
SVMSINSTAL-I-RESTORE, Restoring product saveset B. 
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Moving VAX Distributed Name Service files. 
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This installation has added the following files: 


[SYSEXE] DNSSADVER. EXE - DNS advertisment process. 
[SYSEXE] DNSSBACK. EXE - DNS background process. 

[SYSEXE ] DNSSCONTROL. BIN - DNS management command parsing table. 
(SYSEXE] DNSSCONTROL. EXE - DNS control program. 

[SYSEXE] DNSS$DISPLAY_TREE.EXE - DNS namespace display utility. 
[SYSEXE] DNSSML.EXE - DNS management listener... 
[SYSEXE] DNSSSOLICIT.EXE - DNS client solicitation process. 
[SYSEXE] DNSSTRANS . EXE - DNS transaction process. 
[SYSHLP]DNS$011.RELEASE NOTES - DNS release notes. 

([SYSHLP ] DNSSHELP . HLB ~- DNS management help library. 
(SYSLIB] DNSS$CLIENT. EXE - DNS client shareable library. 
[SYSLIB] DNSSLIB.EXE ~ DNS shareable library. 


[SYSMGR] DNS$CHANGE_DEF FILE.COM- DNS change default server command file 
[SYSMGR] DNS$CLIENT_ STARTUP.COM - DNS client startup command file. 
[SYSMGR] DNS$CLIENT_ STOP.COM DNS client shutdown command file. 


[SYSMGR] DNS$STARTUP .COM - DNS startup command file. 

([SYSMGR] DNSSSTOP .COM - DNS shutdown command file. 

[SYSMSG] DNS$MSG.BIN - DNS management text file. 

{SYSMSG] DNSSMSG. EXE ~ DNS error message file. 

[SYSTEST]DNSSIVP .COM - DNS installation verification procedure. 
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Starting VAX Distributed Name Service 
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Creating clearinghouse, please wait ... 
Clearinghouse filename DUA1: [DNS$SERVER] plapen_ch. DNS 
%RUN-S-PROC_ID, identification of created process is 00000118 


Adding access to the new clearinghouse for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding access to the new clearinghouse for user SYSTEM. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding access to the root directory for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding DEFAULT access to the root directory for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


a 
VAX Distributed Name Service Post-Installation Instructions 


Add a call to the DNS startup command procedure SYSSMANAGER:DNSSSTARTUP.COM 
to the site specific startup command procedure SYS$MANAGER: SYSTARTUP_V5.COM. 
This command must follow the STARTNET.COM and the START/QUEUE/MANAGER, so 
that DECnet and the queve manager start before the DNS server. 
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DNS startup installs shareable libraries and global sections, creates 
permanent detached processes, and adds DECnet objects. 


To implement the "DNSCP" command, which executes the DNS server 
Control Program, the following command line should be added to the system 
login command file (filename = SYSSMANAGER:SYLOGIN.COM) : 


$ DNSCP :== SDNSSCONTROL !Foreign command to run DNS utility. 


You can run the installation verification procedure at any time by 
typing: 


$ @SYSSTEST: DNSSIVP 


There are two DECnet event classes associated with this product, they 
are events 352 and 353. The following commands are included in 
DNSS$STARTUP .COM: 


$ NCP SET KNOWN LOGGING EVENTS 352.* 
$ NCP SET KNOWN LOGGING EVENTS 353.1,2,3,4 


VAX Distributed Name Service Installation Verification Procedure 


DNSCP SHOW CHARACTERISTICS CLEARINGHOUSE PLAPEN CH 
Directory PLAPEN NS:. 


DNSCP CREATE GROUP PLAPEN_DNS$IVP 

UID aa-00-04-00-56-12-70-ea-4f£-86-5b-0f~91-00 
DNSCP ADD MEMBER PLAPEN::SYSTEM GROUP PLAPEN DNS$IVP 

DNSCP SHOW CHARACTERISTICS GROUP PLAPEN DNS$IVP 
Member _—s plapen::system (PLAPEN NS: .DNS$IV.plapen. system) 

DNSCP DELETE GROUP PLAPEN DNSS$IVP 

Installation of Distributed Name Service V1.1 successful. 

Installation of DNS V1.1 completed at 15:42 

VMSINSTAL procedure done at 15:43 

P 
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C.2 Sample Installation Dialogue: Existing Namespace 


$ @SYSSUPDATE:VMSINSTAL DNSO11 MUAO: [RET 


VAX/VMS Software Product Installation Procedure V5.0 
It is 6-APR-1988 at 15:57. 
Enter a question mark (?) at any time for help. 


*SVMSINSTAL~W-DECNET, Your DECnet network is up and running. 
* Do you want to continue anyway [NO]? YES [AET| 
* Are you satisfied with the backup of your system disk [YES]? 


Please mount the first volume of the set on MUAO:. 
* Are you ready? YES 
%SMOUNT-I-MOUNTED, DNS mounted on _BANANASMUAO: 
The following products will be processed: 
DNS V1.1 
Beginning installation of DNS V1.1 at 15:57 


SVMSINSTAL-I-RESTORE, Restoring product saveset A... 
SVMSINSTAL-I-RELMOVED, The product’s release notes have been successfully moved to 


SYSSHELP. 
VAX Distributed Name Service Installation. 


%DNS-I-LICCHECK, Checking for DNS license on this system 


Product: DNS 
Producer: DEC 
Version: 1.1 


Release Date: 1-MAY-1988 
* Does this product have an authorization key registered and loaded? YES 


Most products provide an Installation Verification Procedure (IVP) 
which verifies the completeness and accuracy of the installation. 
You may wish to run the IVP immediately after installation. 


* Do you want to run the IVP after the installation [YES]? 


During this installation, new files will be provided to replace existing 
versions. You may purge these older versions to save disk space, or keep 
them if you feel they may be of use. Purging is recommended. 


* Do you want to purge files replaced by this installation [YES]? 


VAX Distributed Name Service Site Specific Questions 


a a 


* Is this a new namespace [NO]? 
Timezone (+hh:mm or -hh:mm): foe eet 
RET 


* Clearinghouse Name [BANANA _CH]: 


* 
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In order to ensure that the VAX Distributed Name Server runs with the 
proper quotas, this installation procedure will create the account 
DNSSSERVER. You must specify a unique UIC for this account in order 
to ensure proper installation. 


* Enter UIC for DNS server account (include brackets) [[371,371]]: |RET 
* Enter password for the DNS server account: password 
* Verify password for the DNS server account: password 


%DNS-I-CREACC, Creating account DNSSSERVER for the VAX DNS server 
SVMSINSTAL-I-ACCOUNT, This installation creates an ACCOUNT named DNSSSERVER. 
%DNS-I-CREDIR, VAX Distributed Name Service creates DNSSSERVER directory 


* Device to be used for storing DNS$SERVER files [SYS$SYSROOT]: DUA1 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSS$SERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
%SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSSSERVER. 
SVMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DNSS$SERVER. 
%SVMSINSTAL-I-RESTORE, Restoring product saveset B... 


a a 
Moving VAX Distributed Name Service files. 
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This installation has added the following files: 


[SYSEXE ] DNSSADVER. EXE - DNS advertisment process. 
[SYSEXE] DNSSBACK.EXE - DNS background process. 

[SYSEXE] DNSSCONTROL. BIN - DNS management command parsing table. 
[SYSEXE ] DNSSCONTROL. EXE - DNS control program. 

[SYSEXE] DNS$DISPLAY TREE.EXE - DNS namespace display utility. 
[SYSEXE] DNS$ML. EXE - DNS management listener.. 
[SYSEXE] DNS$SOLICIT.EXE - DNS client solicitation process. 
[SYSEXE] DNS$TRANS . EXE - DNS transaction process. 
[SYSHLP]DNS$011.RELEASE NOTES - DNS release notes. 

[SYSHLP ] DNSSHELP . HLB ~ DNS management help library. 
[SYSLIB] DNS$CLIENT. EXE ~ DNS client shareable library. 
[SYSLIB] DNS$LIB.EXE - DNS shareable library. 


[SYSMGR] DNSS$CHANGE_DEF_FILE.COM- DNS change default server command file 
[SYSMGR] DNS$CLIENT_STARTUP.COM - DNS client startup command file. 


[SYSMGR] DNS$CLIENT_STOP.COM - DNS client shutdown command file. 
[SYSMGR] DNS$STARTUP .COM - DNS startup command file. 

[SYSMGR] DNS$STOP .COM - DNS shutdown command file. 

[SYSMSG] DNS$MSG.BIN - DNS management text file. 

[SYSMSG] DNS$MSG. EXE DNS error message file. 

[SYSTEST]DNSSIVP .COM - DNS installation verification procedure. 


VAX Distributed Name Service Client Installation 
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Installing VAX Distributed Name Service Client 


A VAX Distributed Name Service Client Interface exists on this system 
from a previously installed product. 


The existing DNS client setup file, SYS$SYSTEM:DNS$DEFAULT FILE.DAT, 
will be appended to the new SYS$SYSTEM:DNS$DEFAULT FILE.DAT . 


The following DNS server nodes have been found. Select a node name 
from this list or the name of another DNS server node. 


BANANA (4.598) 

* Enter the name of an existing DNS server node: APPLE 

%COPY-S-COPIED, APPLE: : SYS$SYSROOT: [SYSLIB] DNS$NS_DEF_FILE.DAT;83 copied to 
VMISROOT: [SYSUPD.DNS011] DNS$DEFAULT_FILE.DAT;1 (1 block) 
%APPEND-S-APPENDED, VMISSPECIFIC: [SYSEXE]DNS$DEFAULT FILE.DAT;2 appended to 
VMIS$ROOT: [SYSUPD.DNSO11]DNS$DEFAULT FILE.DAT;1 (5 records) 

%RUN-S-PROC_ID, identification of created process is 00000152 
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Creating clearinghouse, please wait 
Clearinghouse filename DUAL: [DNS$SERVER] banana_ch.DNS 


Adding access to the new clearinghouse for all users on all nodes. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


Adding access to the new clearinghouse for user SYSTEM. 
The access rights are READ, WRITE, DELETE, TEST, and CONTROL. 


VAX Distributed Name Service Post-Installation Instructions 


Add a call to the DNS startup command procedure SYSS$MANAGER: DNSSSTARTUP.COM 
to the site specific startup command procedure SYS$MANAGER:SYSTARTUP_V5.COM. 
This command must follow the STARTNET.COM and the START/QUEUE/MANAGER, s0 
that DECnet and the queue manager start before the DNS server. 


DNS startup installs shareable libraries and global sections, creates 
permanent detached processes, and adds DECnet objects. 


To implement the "DNSCP" d¢ommand, which executes the DNS server 
Control Program, the following command line should be added to the system 
login command file (filename = SYSSMANAGER: SYLOGIN.COM) : 


$ DNSCP :== S$DNSSCONTROL !Fereign command to run DNS utility. 


You can run the installation verification procedure at any time by 
typing: 


§ @SYSSTEST: DNSSIVP 


There are two DECnet event classes associated with this product, they 
are events 352 and 353. The following commands are included in 
DNSSSTARTUP.COM: 
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$ NCP SET KNOWN LOGGING EVENTS 352.* 
$ NCP SET KNOWN LOGGING EVENTS 353.1,2,3,4 
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DNSCP SHOW CHARACTERISTICS CLEARINGHOUSE BANANA_CH 
Directory APPLE _NS:. 


DNSCP CREATE GROUP BANANA_DNSSIVP 
UID aa-00-04-00-97-11-00-51-b4-45-5£-0f£-91-00 
DNSCP ADD MEMBER BANANA: :SYSTEM GROUP BANANA _DNS$IVP 


DNSCP SHOW CHARACTERISTICS GROUP BANANA_DNS$IVP 
Member BANANA:: system (APPLE NS: .DNS$IV.banana. system) 


DNSCP DELETE GROUP BANANA_DNSS$IVP 
Installation of Distributed Name Service V1.1 successful. 
Installation of DNS V1.1 completed at 16:11 


VMSINSTAL procedure done at 16:11 
$ 
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A 


Access rights * 1-8, 2-12 

assigning « 1-9 

defaults * 2-13 

displaying » 3-1 

granted by DNS installation « 3—1 

’ modifying » 3-2 

ADD ACCESS command « 3-2 
ADD MEMBER command + 2-14 
AUTOGEN utility - 1-5 


BADCLOCK message ° 1-8 
Batch queue * 3-6 
BYTLM quota 


see Installation, requirements 


C 


Clearinghouse 
database + 2-10 
default name « 1-9, 2-8 
name « 1-10, 2-8, 2—12, 3-3 
object 
directory for storing * 1-9 
required access rights « 1-9 
storing in a directory * 2-8. 
UID + 3-3 
Client 
cache «3-3 
shutdown command file * 2-11 


‘Index 


Client (cont’d.) 

start-up command file * 2-11 
CMKRNL privilege + 14 
CREATE GROUP command « 2-14 


D 


DELETE GROUP command « 2-14 
DFS (VAX Distributed File Service) * 1—1 
Disk space requirements 

see Installation, requirements 
DNS$010.RELEASE_NOTES file «2-11, A~2 
DNS$011.RELEASE_NOTES file > A—1 
DNS$ADVER.EXE file * 2-11, A-2 
DNS$ADVER process:1-6 
DNS$BACK.EXE file » 2-11, A-2 
DNS$BACK process «. 1-5 
DNS$CHANGE_DEF_FILE.COM file » A-2 
DNS$CLIENT.EXE file » 2-11, A-2 
DNS$CLIENT_STARTUP.COM file * 2-11, A-2 
DNS$CLIENT_STOP.COM file * 2-11, 3-5, A-2 
DNS$CONTROL.BIN file » 2-11, A-2 
DNS$CONTROL.EXE file - 2-11, A-2 
DNS$DEFAULT_FILE.DAT file « A-3 
DNS$DISPLAY_TREE.EXE file «2-11, A-2 
DNS$GLOBAL.GBL file - A-3 : 
DNS$GLOBAL_CACHE.GBL file » A-3 
DNS$HELP.HLB file * 2-11, A-2 
DNS$IVP.COM « 2-11 
DNS$IVP.COM file » A-2 
DNS$LIB.EXE file * 2-11, A-2 
DNS$ML.EXE file + 2-11, A-2 
DNS$MSG.BIN file » 2-11, A-2 
DNS$MSG.EXE file * 2-11, A-2 
DNS$NS_DEF_FILE.DAT file + 3-3, A-3 
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DNS$SERVER account + 2-9 

device * 2-10 

log file * 3-6 

UIC + 2-9 
DNS$SOLICIT.EXE file «2-11, A-2 
DNS$STARTUP.COM file ¢ 2-2, 2-11, 3-3, A-2 
‘DDNS$STOP.COM file » 2~11, 3-5, A-2 
DNS$TA process « 1-5 
DNS$TRANS.EXE file » 2-11, A-2 

DNS messages 

file * 2-11 
DNS server 

name ¢ 2-12 


E 


Event codes ° 3-3 
Event logging + 3-3 
enabling + 3-3 


G 


Global pages 

see Installation, requirements 
Global sections 

see Installation, requirements 
GROUP privilege + 1-4 
GRPPRV privilege + 1-4 


H 


Hardware requirements 
see Installation, requirements 


installation 
error messages * 4-1 to 4-4 
example - B—-1, B-5, C—1, C-5 
requirements ¢ 1-2 
BYTLM quota « 1-4 
disk space « 1-3 
global pages « 1-6 
global sections « 1-6 
hardware « 1-3 
kit contents « 1-2 
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Installation 

tequirements (cont'd.) 
multiserver networks ¢ 1-7 
open file quota > 1-4 
privileges « 1-4 
processes « 1-5 
queue manager « 2-5 
software * 1-3 
system disk « 1-3 
system parameters « 1-5 
time ° 1-7 

verification 
during VMSINSTAL « 2-6 
invoking the IVP « 2-13 
IVP completion message + 2-14 
IVP error messages * 2-15 
IVP functions * 2-14 
time * 1-7 

IVP (installation Verification Procedure) 
see Installation, verification 





A 


KITINSTAL.COM file * A-1 





r 


License PAK (License Product Authorization Key) « 
1-3 
LMF (License Management Facility) > 1-3 





MODPARAMS.DAT file + 1-6 





= 


Namespace 
creating * 2-7, 2-11, 2-12, 2-13 
default name « 2-7 
hierarchical 
storing clearinghouse objects + 2-8 
name ¢ 2-7, 3-3, 3-4 
UID + 3-3 
NETMBX privilege « 1-4 


O 


Open file quota requirements 
see Installation, requirements 
OPER privilege + 1-4 
Pp 
PAK see License PAK 
PFNMAP privilege « 1-4 
Postinstallation procedures «3-1 to 3-6 
instructions * 2-13, 3-4 
running the IVP + 3-5 
_ Starting DNS « 3-4 
Preinstallation considerations * 1-1 to 1-10 
Privileges requirements 
see Installation, requirements 
PRMGBL privilege + 1-4 
Process requirements 
see Installation, requirements 
Product Authorization Key see License PAK 


R- 


Release notes ¢ 2-3 
displaying * 2—4 
printing * 2-4 
REMOVE ACCESS command + 3-2 
Root directory 
storing clearinghouse object + 1-9, 2-8 
RSM (Remote System Manager) « 1-1 


S 


SET LOGGING command « 3-3 

SETPRV privilege + 1-4 

SET TIME command: 1-8 

SHMEM privilege * 1-4 

SHOW ACCESS DIRECTORY command « 3-1 

SHOW CHARACTERISTICS CLEARINGHOUSE 
command « 2-14 

SHOW CHARACTERISTICS GROUP command « 
2-14 

Software requirements 

see Installation, requirements 








SYSGBL privilege « 1-4 
SYSGEN utility * 1-6 
SYSNAM privilege « 1-4 
SYSPRV privilege + 1-4 
System parameters 

see Installation, requirements 
System time 

synchronizing ° 1-8 


T 


Timezone ¢ 2-7 
TMPMBxX privilege - 1-4 


U 


UAF (user authorization file) * 1-4, 1-5 
UIC (user identification code) « 2-9 
UID (unique identification number) « 2-14 


V 


VAXcluster 
alias * 1-7, 2-12 
installing DNS on 1-7 
VMSINSTAL procedure « 2—1 
aborting * 2-1 
batch queue created * 2--2 
creating a namespace ° 2-7 
default responses « 2—1 
files added « 2-10 
help * 2-1, 2-2 
invoking * 2—2 
logging * 2-1 
options N « 2-4 
purging files » 2-6 
running the IVP + 2-6 
setting the timezone * 2-7 
step-by-step description * 2-2 
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HOW TO ORDER ADDITIONAL DOCUMENTATION 


DIRECT TELEPHONE ORDERS 


In Continental USA In Canada In New Hampshire 
call 800-DIGITAL call 800-267-6215 Alaska or Hawaii 
call 603-884-6660 


In Puerto Rico 
call 809-754-7575 x2012 


ELECTRONIC ORDERS (U.S. ONLY) 


Dial 800-DEC-DEMO with any VT100 or VT200 
compatible terminal and a 1200 baud modem. 
If you need assistance, call 1-800-DIGITAL. 


DIRECT MAIL ORDERS (U.S. and Puerto Rico*) 


DIGITAL EQUIPMENT CORPORATION 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


DIRECT MAIL ORDERS (Canada) 


DIGITAL EQUIPMENT OF CANADA LTD. 
940 Belfast Road 
Ottawa, Ontario, Canada K1G 4C2 
Attn: A&SG Business Manager 


INTERNATIONAL 


DIGITAL 
EQUIPMENT CORPORATION 
A&SG Business Manager 
c/o Digital’s local subsidiary 
or approved distributor 


Internal orders should be placed through the Software Distribution Center (SDC), 
Digital Equipment Corporation, Westminster, Massachusetts 01473 


*Any prepaid order from Puerto Rico must be placed 
with the Local Digital Subsidiary: 
809-754-7575 x2012 
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